home *** CD-ROM | disk | FTP | other *** search
/ Aminet 6 / Aminet 6 - June 1995.iso / Aminet / util / boot / OSP12.lha / OpenScreenPatch / OpenScreenPatch.doc < prev    next >
Encoding:
Text File  |  1995-03-09  |  5.4 KB  |  129 lines
  1. ---------------------------------------------------------------------------
  2.                           OpenScreen-Patch V1.01
  3.  
  4.                    (c) 1994 Laserdance Productions / TSB
  5.  
  6.                            English documentation
  7. ---------------------------------------------------------------------------
  8.  
  9.  
  10. ------------------------------ Introduction -------------------------------
  11. ---------------------------------------------------------------------------
  12.  
  13. Well,  if you have a Multisync-monitor, you'll propably know the problem of
  14. these nasty grey borders around the screens, as the display doesn't fill up
  15. all  your  screen.   Here  is  a  very  simple  solution  to your problem :
  16. OpenScreenPatch !
  17.  
  18. This  little program will patch the OpenScreen-routines in a way that every
  19. time  a screen has successfully opened the genlock-borderblank bit will get
  20. set. It looks very nice.
  21.  
  22. As   said,   the   program   modifies   the   OpenScreen-function   in  the
  23. intuition.library, so already opened screens will not be patched.  For best
  24. results  call  the program in your startup-sequence before the first screen
  25. is opened, i.e.  before IPrefs.
  26.  
  27.  
  28. ------------------------------ Installation -------------------------------
  29. ---------------------------------------------------------------------------
  30.  
  31. The  program  is  a  quick-'n'-dirty-hack, so there is no userinterface, to
  32. keep the program as short as possible.  The program will patch OpenScreen()
  33. and  OpenScreenTags()  via  SetFunction().   Then  it  will  Wait()  for  a
  34. Control-C-break and upon receiving such a break will remove the patches and
  35. reset  the  vectors  to their original state.
  36.  
  37. So  if you want to remove the patch simply issue a 'status'-command in your
  38. shell, get the process number of OpenScreenPatch, and then enter 'break n',
  39. where n is the process-number.
  40.  
  41. If somebody else has patched the library after OpenScreenPatch, the program
  42. will  issue a beep, cause the display to flash and fall back to the waiting
  43. state,  as  it would be dangerous to remove the patch, if somebody else has
  44. patched OpenScreen.
  45.  
  46.  
  47. ---------------------------------- Bugs -----------------------------------
  48. ---------------------------------------------------------------------------
  49.  
  50. Well,  there  is no known bug, except the fact, that the OpenScreenPatch is
  51. not  startable  from  workbench.  But I think this is not necessary, as the
  52. program was intended for used from the shell (i.e.  the startup-sequence).
  53.  
  54. A  thing  worth  mentioning  is the fact that OSP runs only under OS 2.0 or
  55. higher, power to those who deserve it !
  56.  
  57.  
  58. --------------------------------- History ---------------------------------
  59. ---------------------------------------------------------------------------
  60.  
  61. V1.0 (9. April 1994)    o First version. Simple but running
  62.  
  63. V1.1 (8. August 1994)    o Added vector check on removal. Won't unpatch if
  64.               somebody else has patched OpenScreen()
  65.             o Programm only worked on A4000. Fixed.
  66.  
  67. V1.2 (12. Febr. 1995)    o Save register is put on stack to ensure multi-
  68.               tasking compatiblity (didn't encounter any probs
  69.               in the last 6 month anyway)
  70.  
  71. ------------------------------- Disclaimer --------------------------------
  72. ---------------------------------------------------------------------------
  73.  
  74. The  program  is  distributed  'as  is'  and no warranty for the quality or
  75. performance of the program is given.  You use the program on your own risk.
  76. If the patch blows up your cat, I can't be made responsible.
  77.  
  78. The  program and source code is GiftWare, and may be freely distributed, as
  79. long  as  no charge, execept for some reasonable copyfees is taken.  If you
  80. use  the program reguarly you are expected to send some kind of gift to the
  81. author  (e.g.   floppy-  or  harddisks,  CDs,  money, booze, some Star Trek
  82. stuff, or a nice postcard of your cat (?)) The sources and executeables are
  83. still  Copyright  ©  1994 Laserdance Productions.  You are free to copy and
  84. modify  this  stuff  for  your  needs,  but _only_ the _unchanged_ original
  85. release archive may be distributed.
  86.  
  87. Original distribution archive contains :
  88.  
  89.     OpenScreenPatch.exe    - The executeable program
  90.     OpenScreenPatch.doc    - English documentation
  91.     OpenScreenPatch.dok    - German documentation
  92.     OpenScreenPatch.s    - Source code
  93.  
  94.  
  95. --------------------------------- Contact ---------------------------------
  96. ---------------------------------------------------------------------------
  97.  
  98. If you want to contact the author for any reason, grap a pen and write some
  99. snail-mail to the following address :
  100.  
  101.                           Laserdance Productions
  102.                               c/o Kai Haseloh
  103.                           Dorotheenstrasse 7/585
  104.                               30419 Hannover
  105.  
  106.                 email : haseloh@informatik.uni-hannover.de
  107.  
  108. --------------------------------- Hellos ----------------------------------
  109. ---------------------------------------------------------------------------
  110.  
  111.                  Hellos go out to the following persons :
  112.  
  113.                      The rest of The Special Brothers
  114.                                Carsten Brühl
  115.                                 Jörg Wabbel
  116.                                Markus Klinge
  117.                Simon Stelling (thx for finding the V1.0 bug)
  118.                               Michael Schaake
  119.                               Markus Schmall
  120.                               Andreas Weyert
  121.                                   Fornax
  122.  
  123.  
  124.  
  125.                     See you in some bigger productions,
  126.  
  127.                Laserdance Productions / The Special Brothers
  128.  
  129.